home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmCreatePulldownMenu.z / XmCreatePulldownMenu
Text File  |  1998-10-30  |  8KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/RowColumn.h>
  14.           WWWWiiiiddddggggeeeetttt XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(
  15.           WWWWiiiiddddggggeeeetttt ppppaaaarrrreeeennnntttt,
  16.           SSSSttttrrrriiiinnnngggg nnnnaaaammmmeeee,
  17.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrgggglllliiiisssstttt,
  18.           CCCCaaaarrrrddddiiiinnnnaaaallll aaaarrrrggggccccoooouuuunnnntttt);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu creates an instance of a RowColumn
  25.           widget of type XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN and returns the associated
  26.           widget ID.
  27.  
  28.           _p_a_r_e_n_t    Specifies the parent widget ID
  29.  
  30.           _n_a_m_e      Specifies the name of the created widget
  31.  
  32.           _a_r_g_l_i_s_t   Specifies the argument list
  33.  
  34.           _a_r_g_c_o_u_n_t  Specifies the number of attribute/value pairs in
  35.                     the argument list (_a_r_g_l_i_s_t)
  36.  
  37.           Specifies the number of attribute/value pairs in the
  38.           argument list (_a_r_g_l_i_s_t).  When this function is used to
  39.           create the Pulldown menu pane, a MenuShell widget is
  40.           automatically created as the parent of the menu pane. If the
  41.           widget specified by the _p_a_r_e_n_t parameter is a Popup or a
  42.           Pulldown menu pane, the MenuShell widget is created as a
  43.           child of the _p_a_r_e_n_t MenuShell; otherwise, it is created as a
  44.           child of the specified _p_a_r_e_n_t widget.
  45.  
  46.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu is provided as a convenience function
  47.           for creating RowColumn widgets configured to operate as
  48.           Pulldown menu panes and is not implemented as a separate
  49.           widget class.
  50.  
  51.           A Pulldown menu pane displays a 3-D shadow, unless the
  52.           feature is disabled by the application.  The shadow appears
  53.           around the edge of the menu pane.
  54.  
  55.           A Pulldown menu pane is used with submenus that are to be
  56.           attached to a CascadeButton or a CascadeButtonGadget. This
  57.           is the case for all menu panes that are part of a
  58.           PulldownMenu system (a MenuBar), the menu pane associated
  59.           with an OptionMenu, and any menu panes that cascade from a
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           Popup menu pane. Pulldown menu panes that are to be
  75.           associated with an OptionMenu must be created before the
  76.           OptionMenu is created.
  77.  
  78.           The Pulldown menu pane must be attached to a CascadeButton
  79.           or CascadeButtonGadget that resides in a MenuBar, a Popup
  80.           menu pane, a Pulldown menu pane, or an OptionMenu. It is
  81.           attached with the button resource XXXXmmmmNNNNssssuuuubbbbMMMMeeeennnnuuuuIIIIdddd.
  82.  
  83.           A MenuShell widget is required between the Pulldown menu
  84.           pane and its parent.  If the application uses this
  85.           convenience function for creating a Pulldown menu pane, the
  86.           MenuShell is automatically created as the real parent of the
  87.           menu pane; otherwise, it is the application's responsibility
  88.           to create the MenuShell widget.
  89.  
  90.           To function correctly when incorporated into a menu, the
  91.           Pulldown menu pane's hierarchy must be considered. This
  92.           hierarchy depends on the type of menu system that is being
  93.           built, as follows:
  94.  
  95.              +o  If the Pulldown menu pane is to be pulled down from a
  96.                 MenuBar, its _p_a_r_e_n_tmust be the MenuBar.
  97.  
  98.              +o  If the Pulldown menu pane is to be pulled down from a
  99.                 Popup or another Pulldown menu pane, its _p_a_r_e_n_t must
  100.                 be that Popup or Pulldown menu pane.
  101.  
  102.              +o  If the Pulldown menu pane is to be pulled down from an
  103.                 OptionMenu, its _p_a_r_e_n_t must be the same as the
  104.                 OptionMenu parent.
  105.  
  106.           PullDown menu panes support tear-off capabilities for tear-
  107.           off menus through XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnnresources.  For a complete
  108.           definition of RowColumn and its associated resources, see
  109.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3).
  110.  
  111.      RRRREEEETTTTUUUURRRRNNNN
  112.           Returns the RowColumn widget ID.
  113.  
  114.      RRRREEEELLLLAAAATTTTEEEEDDDD
  115.           XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn(3), XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt(3),
  116.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeOOOOppppttttiiiioooonnnnMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu(3),
  117.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(3), XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll(3),
  118.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(3).
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.